The UUCPGate is a CommuniGate communication module supporting e-mail message transfer using the uucp protocol and regular modem connections; uucp communications do not require a direct Internet connection (i.e. they do not use the TCP/IP protocol).
The UUCPGate module supports multi-line communications and can support connections with several other uucp systems (so your CommuniGate system can be a network provider for other uucp e-mail systems).
The UUCPGate module can work together with SMTP module providing both TCP/IP and UUCP Internet e-mail. The CommuniGate Router takes care of directing messages to a proper gate.
Installation
Place the UUCPGate module into the Modules folder that has been created inside the CommuniGate Folder in your System Folder. Restart the CommuniGate Server (by restarting the MacOS on that computer).
Configuring
After the UUCP module is placed in the Modules folder on the server computer, you can configure it from any workstation that has the "can configure" privilege.
1. Choose UUCP Gate from the Monitor section of the Server menu.
2. When the UUCP Monitor window appears, choose "Service Settings…" from the UUCPGate menu. Enter the uucp "host name" (also called "system name") in the "system name" field. If you use a network provider, this name should be assigned to you by that company.
3. Choose Add Line from the UUCP Gate menu. Select the "host descriptor" radio button and enter the UUCP system name of the host you want to make connections to. Your network provider should inform you about the UUCP system name of their host. Click Create, and the Host record should appear in the UUCPGate Monitor window.
4. Select Line Settings… from the UUCPGate menu. The Host Settings dialog box should appear.
5. Select the "Call this Host" option, and enter the login name and password to be used when connecting to this host. Your network provider should inform you about the login name and the password assigned to you.
6. The table on the bottom part of the dialog box contains the call schedule for this host. Use the Add.../Remove/Edit buttons to create and modify the schedule. Each entry contains the time period you want to call this host (for example, 23:00-06:00 can be used to allow calls at night time only), how often you want to call this host if the server does not have any message to deliver (i.e. how often do you want to poll the host to get mail from it), and how often you want to call this host if you have mail to be delivered to that host. The last field contains the phone number to be used.
7. When you make UUCP connections not only with some network provider host, but with other systems as well (acting as a network provider for them, for example), you may create more host descriptors. If some of those systems are expected to call your system, you should check the "This host calls in" option. You should assign a login name/password pair to that host, and inform that host's postmaster, so she/he can configure their system.
8. Choose the "Add Line" from the UUCPGate menu and select the "Communication Line" option. The menu appears and lists the serial ports available on the server computer. The LineShare ports are shown in bold. The ports currently in use with other applications modules have their names dimmed. Select the serial port you want to use for UUCP connections and click "Create". The Line monitor appears in the UUCPGate Monitor window.
9. Since the UUCP Gate Monitor window has several entries now, you have to select an entry in order to configure it. Click to select the communication line entry and choose Line Settings from the UUCPGate menu. Set the operation mode for this line, and set the log level.
Note: if you select the "All Info" log level, the log file will become very large very soon and the system may operate slowly when a uucp connection is in progress.
10. If you have several modems to be used for UUCP, create more Communication Lines using the "Add Line" menu item, and configure them as well.
Attachments
The UUCPGate converts all attachments on the fly into the BinHex format while sending the message. It also detects the BinHex enclosures in the incoming messages and converts them into the attachments. If conversion fails, the unmodified original BinHex text is included in the message body.
Routing (advanced users only)
When the CommuniGate Server Router cannot route a message to any other module, and UUCPGate is the only e-mail module installed, then all the messages are routed via the first host defined with this module. If the only UUCP host defined is the network provider's uucp host, this does what you need: all e-mail messages that should not go to any user on the same server will be sent to Internet via the network provider's host.
If you plan to connect to several hosts, you should not only create the descriptions of those hosts with the "Add Line" command, but you should also enter the domain names and routing information into the CommuniGate Server Router (see the Read Me First file).
Special e-mail addresses
There are some certain types of e-mail addresses that are detected by the UUCPGate module itself and routed to uucp hosts:
messages with addresses of type xxxxx@bbbb.uucp will be routed to the uucp host "bbbb"
messages with addresses of type xxxxx@bbbb or bbbb!xxxxx where bbbb has no period signs (.) will be routed to the uucp host "bbbb".
Miscellaneous
The UUCPGate module keeps the original RFC822 message header with the message, and creates such a header when it sends a message that does not contain one. The current version of CommuniGate does not have a "legal" way to view those headers, but you can do so by opening the message, selecting the subject field and pressing <ctrl>R.
